home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 4 / Atari Forever 4.zip / Atari Forever 4.iso / SERIE_S / S_794 / SMF_PLAY / SMF_PLAY.ENG < prev    next >
Text File  |  1998-03-14  |  5KB  |  127 lines
  1.  
  2.  
  3.  
  4.                      Short-documentation for "SMF-PLAYer"
  5.                        © 1994,1995 by Bogi-Productions
  6.                           Standard-MIDI-File-Player
  7.                                   FAIRWARE
  8.  
  9.                                 Peter Bogner
  10.                                Humbserstr. 10
  11.                                 D-90763 Fürth
  12.                E-Mail: prbogner@cip.informatik.uni-erlangen.de
  13.  
  14.                     Mai 30 1994 - Last changed: Mar 3 1995
  15.  
  16.  
  17.  
  18.  
  19. Please ignore my poor english, I don't have spent much time in writing this
  20. short text.
  21.  
  22.  
  23. Most of the program features are self-explanatory, therefore I describe only
  24. some of the main functions:
  25.  
  26. * The programm was written to play Standard-MIDI-Files (short SMF).
  27.   The play-algorithm I use is based on Steve Goldthorp's 'midi file
  28.   interpreter for midiplay' (Dated July 91) which I found on Internet.
  29.   (on ftp-site ftp.cs.ruu.nl /pub/MIDI/PROGRAM/ATARI/midiplay.zoo).
  30.   I made some changes (unfortunetly no timing-improvements) and compiled it
  31.   with Pure C (the original was compiled with Sozobon C - maybe my version
  32.   will be faster?).
  33.  
  34. * Furthermore I've written a GEM-like environment (I hope it's GEM-like!):
  35.   All dialog-boxes are shown in GEM-windows.
  36.   Buttons can be handled by using your keyboard (Underlined key in
  37.   combination with ALTERNATE, e.g. ALTERNATE-P for playing a loaded SMF).
  38.   (For writing this environment I used the libaries MyDials from Olaf
  39.   Meisiek and NKCC from Harald Siegmund)
  40.  
  41. * In the 'settings'-box it's possible to set some play-parameter like
  42.   Pitch Bending, After Touch etc. (A crossed box means switch on.)
  43.   Midi Clock allows you to synchronize your extern MIDI-equipment with the
  44.   play-function (especially a Drum-computer or a sequencer).
  45.  
  46.   Please note: the option 'Bank select' has only an effect if the
  47.   'Control change' Switch is 'On' (crossed). Otherwise no bank select
  48.   messages are sent.
  49.  
  50. * Using a static SMF-Buffer leads to a restriction by SMFs (no dynamic
  51.   memory management):
  52.   The maximum SMF-size is restricted to 128kB (exactly 131072 Bytes)
  53.   Longer SMF-Files are refused by my program.
  54.  
  55.   Also SMF-Format 0 and 1 are allowed. Format 1 up to 32 Tracks!
  56.  
  57. * Playing a SMF can be interrupt by a mouse-click on the 'stop'-button
  58.   while a smf is played.
  59.   Please note: The mouse-key must be pressed longer!
  60.  
  61. * Playing a SMF can be interrupt by pressing CTRL-C.
  62.   Please note: Mostly the keys must be pressed longer!
  63.  
  64. * The program should run on all ATARI ST, STE, MEGA STE, TT, Falcon, also
  65.   with only 512kB-Machines.
  66.  
  67.   For the ST-high resolution the reource file is included in the program.
  68.   If you want to run it on ST-low or ST-medium you need the resource file
  69.   'smf_med.rsc' in the program directory.
  70.  
  71.   By renaming the program from 'smf_play.app' to 'smf_play.acc' you can
  72.   install it as a desk accessory. (Please note that it's not possible to
  73.   work while playing a SMF - no multitasking!)
  74.  
  75.  
  76. -------------------------------------------------------------------------------
  77.  
  78. D I S C L A I M E R
  79. ===================
  80. SMF-PLAYer does not come with any warranty, express or implied.
  81.  
  82. If you use SMF-PLAYer, you do so at your own risk.
  83.  
  84. Neither the author of SMF-PLAYer (Peter Bogner) nor any other party
  85. will accept responsability for any equipment damage, data loss,
  86. or other unforseen consequence of the use or mis-use of SMF-PLAYer.
  87.  
  88.  
  89. D I S T R I B U T I O N  (for foreign user - outside of Germany)
  90. =======================
  91. There are some limitations placed on the distribution of SMF-PLAYer:
  92.  
  93. 1) When distributed, SMF-PLAYer must contain all files found in the
  94. original archive. Do not change them (archive and files) in any way!
  95.  
  96. 2) SMF-PLAYer may not sold for profit by any way.
  97.                  ^^^^^^^^^^^^^^^^^^^^^
  98. That includes also Public Domain completions which are sold for
  99. more than the costs of the disk and a little copy-fee.
  100. Distribution of the program on a CD-ROM, on channel-videodat etc.
  101. isn't allowed without my explicit written consent!
  102. If you want do this you need my written consent, please send me a
  103. little note - not doing this is illegal.
  104.  
  105. Distribution of SMF-PLAYer with (sold) SMFs isn't allowed without
  106. my written consent.
  107.  
  108. German users have to read the part 10 (Nutzungs-, Verbreitungs-
  109. und sonstige Bestimmungen) of the german documentation.
  110.  
  111.  
  112. -------------------------------------------------------------------------------
  113.  
  114. If you have any Suggestions, Bug-Reports, Questions etc. please contact me,
  115. my (email-) adress is written on the top of the text.
  116.  
  117. You could send me also (own) SMF's which can be played with this program
  118. or other midi-software (for Atari ST, ...), fees, error-free translations
  119. of my german documentation and this short documentation etc.
  120.  
  121. (-> FAIRWARE)
  122.  
  123. /*
  124.  * fin
  125.  */
  126.  
  127.